home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 029a / grepfv4.zip / GREPFV3.DOC < prev   
Text File  |  1991-11-29  |  3KB  |  93 lines
  1. GREPFV version 3
  2. By Nigel Salt (c) 29th November 1991
  3. All rights reserved
  4.  
  5. GREPFV is a text string searching utility with a difference. It
  6. searches for regular expressions in text files, archived files,
  7. and executable files. It will automatically unarchive ZIP, PAK,
  8. ZOO, LZH, and ARC files providing that you have a copy of FV.COM
  9. and the necessary archive managers in your path.
  10.  
  11. FV.COM is Vernon Buerg's addon for LIST. It is available on most
  12. BBSs.
  13. The archivers required are
  14. ARC           arc.exe
  15. ZOO           zoo.exe
  16. LZH           lharc.exe
  17. PAK           pak.exe
  18. ZIP           pkunzip.exe
  19.  
  20. The syntax for grepfv is
  21. grepfv "regexp" filepattern[+] tempdir
  22. where
  23.  
  24. REGEXP is a pattern made up of ASCII characters plus the
  25. following special "wild cards". Enclose the pattern in quotes to
  26. avoid DOS misunderstanding the special characters. Searching for
  27. a backslash poses particular problems because DOS treats it as an
  28. escape character. To look for a backslash you actually have to
  29. specify "\\\\" as the pattern. DOS then translates this to "\\"
  30. which causes grepfv to look for a literal backslash.
  31.  
  32. All searches are case insensitive
  33.  
  34. REGULAR EXPRESSIONS:
  35. \            treat next char as literal
  36. .           match any single character
  37. *            match 0 or more characters
  38. &            preceeding expression AND following expression
  39. |            preceeding expression OR following expression
  40.  
  41. FILEPATTERN is a dos type file specification including wildcards.
  42. If you want to search all of the files in a directory then end
  43. the filepattern with a \. If you want to search all of the files
  44. in subdirectories too then add a + to the end of the filepattern.
  45. For example "\ns\" searches all files in the \ns directory,
  46. "\ns\nigel.*" searches all files in the \ns directory that are
  47. called nigel, "\ns\nigel.*+" searches all files called nigel in
  48. the \ns directory and all of its subdirectories.
  49.  
  50. TEMPDIR should preferably be a RAM disc. It is the location that
  51. grepfv will use to temporarily explode the files in the archives
  52. which it searches. The temporary directory must be on a drive
  53. with enough free space to hold the largest file in the archive.
  54.  
  55. Examples
  56.  
  57. 1. grepfv "vga" tools.zip f:
  58. Searches all of the files in tools.zip for vga and uses drive f
  59. for temporary files
  60.  
  61. 2. grepfv "cga|vga" \tools\
  62. Searches all files in the directory \tools of the current drive
  63. for cga or vga using the current drive for temporary files
  64. because no alternative was specified. Note the trailing backslash
  65. on tools; without it grepfv would look for a file called tools in
  66. the root directory.
  67.  
  68. 3. grepfv "cga&vga" \tools\+
  69. Searches all of the files in tools and its subdirectories for
  70. line which contain both the word cga and vga.
  71.  
  72. Copyright
  73. ---------
  74. grepfv.zip may be distributed freely as long as this document
  75. is left unchanged.
  76.  
  77. If you keep it you should register it by sending a donation of
  78. not less than 10 UK pounds cash (in any currency) to me. Please
  79. honour this arrangement I am in dire need of an upgrade for my
  80. development machine.
  81.  
  82. Nigel Salt
  83. 25 Lower Station Rd
  84. Crayford
  85. Kent
  86. DA1 3PY
  87.  
  88. Phone +44 322 553260
  89.  
  90. CIX ID nao@cix.complink.co.uk
  91. RAX Nigel Salt on node 2:440/52.49
  92.  
  93.